home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0783 / importer.doc next >
Text File  |  1997-04-10  |  8KB  |  190 lines
  1.         -----------------------------------------------
  2.                   WinterWare
  3.            Documentation for NETC Bookmarks Importer
  4.            Copyright (C) 1996  Christopher P. Winter
  5.         -----------------------------------------------
  6.  
  7.         How to Import Netcruiser Bookmark files into Netscape
  8.  
  9.  
  10. The tech support folks at Netscape Communications are prompt and usually
  11. knowledgeable about the products they support.  However, I've found that on
  12. some topics they are a little behind the curve.  This is probably due to
  13. the incredibly fast growth of the company.
  14.  
  15. One such topic is how to import the entries from Netcruiser's NETCOM.BM
  16. bookmarks file.  I was on the phone with Netscape tech support the other day
  17. (1/03/1996) and was told that, despite what the handbook says, their browser
  18. will import an ASCII text file and add its entries to the bookmarks list.
  19.  
  20. I won't repeat the procedure I was told to follow, because I tried it and
  21. it doesn't work.  Netscape insists that there be HTML tags around all those
  22. URLs.  If they're not there, it simply ignores the entries.  (I speak here of
  23. Netscape Personal Edition version 1.2 for Windows 3.1 and Netscape Navigator
  24. 16-bit version 2.0, which are what I personally have used.  Other versions may
  25. handle plain, un-tagged ASCII.)
  26.  
  27. So: in order to get all those hard-won Netcruiser URLs into Netscape, you
  28. have two options.  You can go on-line with Netscape and re-type each one
  29. manually; or, you can follow the procedure below.
  30.  
  31.  
  32. The procedure:    1 -- Use an ASCII editor, such as MSDOS 6.22 "Edit",
  33.              to fix up your NETCOM.BM file as needed.        **
  34.  
  35.         2 -- Save a backup copy of this file.
  36.  
  37.         3 -- Insert the HTML tags into the working copy of
  38.              the file.
  39.  
  40.         4 -- Move the tagged version of the file into
  41.              your Netscape directory.                ++
  42.  
  43.         5 -- Fire up Netscape and select the menu item
  44.              Bookmarks | View Bookmarks.
  45.  
  46.         6 -- Go to the File selection in this window ( _NOT_
  47.              the main File item!) and pick Import.  It will
  48.              bring up a typical File Manager window.
  49.  
  50.         7 -- Tell it to show all files (*.*), not just *.HTM.
  51.  
  52.         8 -- Highlight NETCOM.BM (or whatever you're renamed it
  53.              to) and click OK.  You should see the new URLs
  54.              appear below those you already had.
  55.  
  56.         9 -- You can now do a File | Save As... (Remember to
  57.              stay in the Bookmarks window) or just do a normal
  58.              Netscape session and let it update BOOKMARK.HTM
  59.              when you exit.
  60.  
  61. The kicker, of course, is step 3.  Not only is it stupefyingly tedious,
  62. but it requires you to learn which tags you need to insert.
  63.  
  64.             ** BUT THERE IS A SOLUTION. **
  65.             ==============================
  66.  
  67. It's called "Importer".  It's a DOS program.  It comes from WinterWare.  When
  68. you run it, it reads your NETCOM.BM file, separates the URL and the title from
  69. each line, inserts the proper HTML tags for each entry, and writes everything
  70. to a new file called NETCBOOK.MRX.
  71.  
  72. It's fast.
  73.  
  74. You can then continue with step 4, using this new file in place of NETCOM.BM.
  75. Because NETCOM.BM isn't changed, you don't even need to back it up.  (Hey
  76. course, you already keep backups of all your data files...  Right?)
  77.  
  78. After doing the Netscape Import steps, you should have a new folder which
  79. contains all the Netcruiser URLs you imported.  This folder will be called,
  80. logically enough, "Importees from Netcruiser".  At this point, you can drag
  81. and drop URLs in the normal way to rearrange things.
  82.  
  83. NOTES
  84. -----
  85.  
  86.     1. You may have noticed the null "ADD_DATE=" and "LAST_VISIT="
  87.        values in the imported entries.  (Plus, if you're using
  88.        version 2.0, "LAST_MODIFIED=".)  Don't worry about these.
  89.        Netscape will fill them in when it saves the file.  (Until
  90.        you call up a given site, the LAST_VISIT value will be 0.)
  91.  
  92.   **    2. I find a lot of the titles for the entries are not useful as
  93.        captured from the Web.  Either they repeat the URL, or they're
  94.        blank (nothing there to capture) or whoever set up the site
  95.        put in a lot of words and very little information.  As in this
  96.        extreme, hypothetical example:
  97.  
  98.         "Welcome to the Home Page of HCA on the World Wide Web"
  99.  
  100.        I mean, the title could have been "HCA's Home Page", right?
  101.        The welcome belongs on the page, not in the title.  And when,
  102.        days or weeks later, you see this bookmark again, how will you
  103.        remember what HCA _is_, anyway?  (Besides "Highly Cryptic
  104.        Acronym".)  And one thing you don't need reminding about is
  105.        that it's a World Wide Web page.
  106.  
  107.        Anyway, because of this, I began to edit certain titles to
  108.        help me remember what their sites were all about.  NETCOM.BM
  109.        makes this very easy.  It's still not hard in BOOKMARK.HTM
  110.        as long as you don't disturb the tags.  Just remember that,
  111.        for each entry, the title is the next-to-last thing on the
  112.        line.  That is, it's everything from just before the final
  113.        </A> back to the previous >.  If there's a length limit,
  114.        I sure haven't run into it yet.
  115.  
  116.   ++    3. Both IMPORTER.EXE and the copy of the NETCOM.BM file it reads
  117.        have to be in your Netscape directory.  Importer will look for
  118.        your NETSCAPE.INI in order to determine which version you use,
  119.        and then attempt to read NETCOM.BM in the current directory.
  120.        If either is missing, it will halt.
  121.  
  122.  
  123. ABOUT WINTERWARE
  124. ----------------
  125.  
  126. WinterWare is a business I started in 1995 to develop and distribute various
  127. software products.  NETC Bookmarks Importer is one of these.  The version you
  128. have, V1.0, is freeware.  That means you don't have to pay for it, and you may
  129. pass around as many copies as you like.  However, since NETC Bookmarks Importer
  130. is a copyrighted work, the copies you make MUST include both the program and
  131. documentation in unaltered form.  Also, you may not profit from distributing
  132. copies of this version of NETC Bookmarks Importer.
  133.  
  134. Improvements are certainly possible, and I have some in mind.  One such is
  135. making the program able to select just the URLs you mark for importing.
  136.  
  137. Whether I actually make these improvements is still undecided.  If you have any
  138. interest in a more flexible version of NETC Bookmarks Importer, or questions
  139. about it or other WinterWare products, you can reach me on the Internet at
  140. Netcom, or on CompuServe.  The addresses:
  141.  
  142.     Internet            cpwinter@ix.netcom.com
  143.     CompuServe            76432,736
  144.  
  145. Be sure to read the following
  146.  
  147.                 DISCLAIMERS
  148.                 -----------
  149.  
  150. In plain language:
  151. -----------------
  152.  
  153.     I do not warrant that WinterWare software will be absolutely
  154. free of bugs, or that it will function on every system configuration.
  155.  
  156.     I accept no liability for losses any user may incur through use
  157. of WinterWare software.
  158.  
  159.     I do not guarantee that I will:
  160.  
  161.     a) support any given user for an unlimited period of time.
  162.  
  163.     b) answer the same question twice for any single user.
  164.  
  165.     c) answer questions not related to the operation of WinterWare
  166.        software -- at least, not without charging a fee for such
  167.        consultation.
  168.  
  169.  
  170. To put it in legal terms...
  171.  
  172.  
  173.     THIS SOFTWARE IS PROVIDED BY WINTERWARE "AS IS" AND ANY EXPRESS OR
  174.     IMPLIED WARRANTIES (INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  175.     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE)
  176.     ARE DISCLAIMED.
  177.  
  178.     IN NO EVENT SHALL I (WINTERWARE) BE LIABLE FOR ANY DIRECT, INDIRECT,
  179.     INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  180.     BUT NOT LIMITED TO: PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  181.     LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  182.     CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  183.     LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  184.     ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF I (WINTERWARE) HAVE
  185.     BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  186.  
  187.     THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THESE PROGRAMS
  188.     IS WITH YOU.  SHOULD ANY OF THE PROGRAMS PROVE DEFECTIVE, YOU ASSUME
  189.     THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  190.